home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / date.man < prev    next >
Encoding:
Text File  |  1989-01-12  |  3.1 KB  |  133 lines
  1.  
  2.  
  3.  
  4. DATE                      User Commands                      DATE
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      date - print and set the date
  10.  
  11. SSYYNNOOPPSSIISS
  12.      ddaattee [-nu] [-d dst] [-t minutes_west] [yymmddhhmm [..ss] ]
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      If no arguments are given, the current date and time are
  16.      printed.  Providing an argument will set the desired date;
  17.      only the superuser can set the date. The -_d and -_t flags set
  18.      the kernel's values for daylight savings time and minutes
  19.      west of GMT.  If _d_s_t is non-zero, future calls to _g_e_t_t_i_m_e_o_f_-
  20.      _d_a_y(2) will return a non-zero _t_z__d_s_t_t_i_m_e.  _M_i_n_u_t_e_s__w_e_s_t pro-
  21.      vides the number of minutes returned by future calls to _g_e_t_-
  22.      _t_i_m_e_o_f_d_a_y(2) in _t_z__m_i_n_u_t_e_s_w_e_s_t.  The -_u flag is used to
  23.      display or set the date in GMT (universal) time.  _y_y
  24.      represents the last two digits of the year; the first _m_m is
  25.      the month number; _d_d is the day number; _h_h is the hour
  26.      number (24 hour system); the second _m_m is the minute number;
  27.      .._s_s is optional and represents the seconds.  For example:
  28.  
  29.           date 8506131627
  30.  
  31.      sets the date to June 13 1985, 4:27 PM.  The year, month and
  32.      day may be omitted; the default values will be the current
  33.      ones.  The system operates in GMT.  _D_a_t_e takes care of the
  34.      conversion to and from local standard and daylight-saving
  35.      time.
  36.  
  37.      If _t_i_m_e_d(_8) is running to synchronize the clocks of machines
  38.      in a local area network, _d_a_t_e sets the time globally on all
  39.      those machines unless the --nn option is given.
  40.  
  41. FFIILLEESS
  42.      /usr/adm/wtmp to record time-setting.  In /usr/adm/messages,
  43.      _d_a_t_e records the name of the user setting the time.
  44.  
  45. SSEEEE AALLSSOO
  46.      gettimeofday(2), utmp(5), timed(8),
  47.      _T_S_P: _T_h_e _T_i_m_e _S_y_n_c_h_r_o_n_i_z_a_t_i_o_n _P_r_o_t_o_c_o_l _f_o_r _U_N_I_X _4._3_B_S_D, R.
  48.      Gusella and S. Zatti
  49.  
  50. DDIIAAGGNNOOSSTTIICCSS
  51.      Exit status is 0 on success, 1 on complete failure to set
  52.      the date, and 2 on successfully setting the local date but
  53.      failing globally.
  54.  
  55.      Occasionally, when _t_i_m_e_d synchronizes the time on many
  56.      hosts, the setting of a new time value may require more than
  57.      a few seconds.  On these occasions, _d_a_t_e prints: `Network
  58.      time being set'.  The message `Communication error with
  59.      timed' occurs when the communication between _d_a_t_e and _t_i_m_e_d
  60.  
  61.  
  62.  
  63. Sprite v1.0               April 1, 1987                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. DATE                      User Commands                      DATE
  71.  
  72.  
  73.  
  74.      fails.
  75.  
  76. BBUUGGSS
  77.      The system attempts to keep the date in a format closely
  78.      compatible with VMS.  VMS, however, uses local time (rather
  79.      than GMT) and does not understand daylight-saving time.
  80.      Thus, if you use both UNIX and VMS, VMS will be running on
  81.      GMT.
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0               April 1, 1987                         2
  130.  
  131.  
  132.  
  133.